home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2000 January / Macworld (2000-01).dmg / Shareware World / Graphics / DeFish / DeFish Help < prev    next >
Text File  |  1999-10-22  |  8KB  |  168 lines

  1. How To — Defish
  2.  
  3. Contents
  4. • Opening Fisheye Images
  5. • Inspecting and Resizing the Images
  6. • Calibrating the fisheye image
  7.   - Setting the fisheye circle
  8.     - Manual adjustment
  9.       - Moving the circle
  10.       - Resizing the circle
  11.         - Changing the radius from the center
  12.         - Changing the diameter, keeping one side fixed
  13.     - Dialog adjustment
  14.        - circle size
  15.        - circle location
  16.        - field of view
  17.        - rotation by ±90° and 180°
  18.        - correcting for radial distortion
  19. • Setting Perspective Parameters
  20.   - Choosing the dependent parameters
  21.   - Setting the field of view
  22.   - Setting the image size
  23.   - Setting the resolution
  24.   - Maintaining a square image
  25.   - Generate hemicube (dangling faces)
  26. • Setting Cylindrical parameters
  27.   - Setting the horizontal field of view
  28.   - Setting the vertical field of view
  29. • Generating a Perspective Image
  30. • Generating a Cylindrical Image
  31. • Batch Processing
  32.   - Starting the batch
  33.   - Setting parameters
  34.     - Selecting type of projection
  35.     - Setting output file name scheme
  36.     - Setting fisheye parameters
  37.     - Setting perspective or cylindrical parameters
  38.   - Fine tuning parameters
  39. • Saving Images
  40. • Saving and restoring Preferences
  41. • Examples
  42.  
  43.  
  44. • Opening Fisheye Images
  45. Drop a single image onto DeFish.
  46. Open a file from the "Open…" item inthe "File" menu.
  47.  
  48. • Inspecting and Resizing the Images
  49. The images can be made larger for inspection. They can be adjusted to any size bny clicking and dragging in the lower right corner. A full screen image can be made by clicking the zoon box in the title bar.
  50.  
  51. • Calibrating the fisheye image
  52.  
  53.   - Setting the fisheye circle
  54.  
  55.     - Manual adjustment
  56. Select "Adjust fisheye Circle" from the "Warp" menu. When done adjusting it, deselect it, to avoid accidental changes. Undo is available for manual adjustment of the fisheye circle.
  57.  
  58.       - Moving the circle
  59. Click and drag in the interior of the circle. The arrow keys may be used to move by one pixel at a time. In combination with the shift key, larger steps are taken.
  60.  
  61.       - Resizing the circle
  62.  
  63.         - Changing the radius from the center
  64. Click on the circle and drag. The center remains fixed.
  65.  
  66.         - Changing the diameter, keeping one side fixed
  67. Option-click on the circle and drag. The opposite side of the circle remains fixed.
  68.  
  69.     - Dialog adjustment
  70.   
  71.      - circle size
  72. This is specified as a percentage of the smaller dimension of the image.
  73.  
  74.        - circle location
  75. This is specified in pixels.
  76.  
  77.        - field of view
  78. This is the field of view represented by the circle.
  79.  
  80.        - rotation by ±90° and 180°
  81. Select one of the radio buttons. The source image itself is not rotated, but rotation is performed upon projection.
  82.  
  83.       - correcting for radial distortion
  84. The coefficients for a cubic polynomial in the azimuth angle may be specified. There is no intuitive way of setting these (yet).
  85.  
  86. • Setting Perspective Parameters
  87.  
  88.   - Choosing the dependent parameters
  89. This uses a nonstandard interface for radio buttions. The highlighted radio buttons indicate independent parameters. Only two of the three sets of parameters are independent, and you can choose which they are. By clicking on the radio button for an independent parameter, you can change it to a dependent one. The highlights always indicate the variables which can be changed. It may be confusing when you click on an unselected boutton, when it doesn't respond. You instead need to click on a selected button to deselect it. By default, the width and height are dependent; these are varied as you change the FOV or zoom. By clicking on the Zoom radio button, you can then adjust the height and width, and the zoom will be adjusted accordingly.
  90.  
  91.   - Setting the field of view
  92. The left box is the horizontal field of view, in degrees. The right is the vertical field of view. If the "square" checkbox is checked, then cthe changes to one wil be copied to the other. A value of 115° will produce as many pixels as in a 180° fisheye image. A value of 120°-140° is good. Larger than this will use an extraordinary number of pixels at the edges. However, I've made 165° and even 170° images, with enough memory. Note that only multifinder memory is used, so it is counterproductive to set the memory partition to anything larger than 2 Mb; even 1 Mb will work for many jobs.
  93.  
  94.   - Setting the image size
  95. If you desire a particular size of image, these fields are for you. Make sure to Unselect another parameter (FOV or zoom) as the independent variable. Otherwise, any changes are ignored.
  96.  
  97.   - Setting the resolution
  98. The dimensions of the resultant image, in pixels, is specified here.
  99.  
  100.   - Maintaining a square image
  101. By uncheckingthis box, you can have independent control of the horizontal and vertical field of view or image dimensions.
  102.  
  103.   - Generate hemicube (dangling faces)
  104. The fisheye can be projected to a hemicube, by checking this box. The central face, plus four additional dangling faces are produced. If a field of view of other than 90° is specified, then the result will be shaped like a half of a cracker box or a cookie box instead of a cube.
  105.  
  106. • Setting Cylindrical parameters
  107.  
  108.   - Setting the horizontal field of view
  109. With a round 180° fisheye image, you can make this the horizontal field of view as large as 180°.
  110.  
  111.   - Setting the vertical field of view
  112. The vertical field of view has the same caveats as for perspective. Angles of 120°-140° make good use of the pixels. Larger values can be used, but are wasteful of pixels.
  113.  
  114. • Generating a Perspective Image
  115. Select "Create Perspective". It may take a while. Zoom in and inspect it if you want.
  116.  
  117. • Generating a Cylindrical Image
  118. Select "Create Cylinder". It may take a while. Zoom in and inspect it if you want.
  119.  
  120. • Batch Processing
  121.  
  122.   - Starting the batch
  123. Drag several images from the Finder onto the DeFish icon. You will be prompted, through a series of dialogs, to set the parameters. When the last one is OK'ed, all the images will be batch processed.
  124.  
  125.   - Setting parameters
  126. A series of dialogs are brought up to set the parameters for the batch.
  127.  
  128.     - Selecting type of projection
  129. Select either perspective or cylindrical.
  130.  
  131.     - Setting output file name scheme
  132. You choose the suffix to be appended to the input file name. You can choose to strip the suffix from the input file name.
  133.  
  134.     - Setting fisheye parameters
  135. This is the same dialog as described above.
  136.  
  137.     - Setting perspective or cylindrical parameters
  138. These are the same dialogs as described above.
  139.  
  140.   - Fine tuning parameters
  141. The batch process normally only accommodates parameter specification through dialogs. However, the interactive fisheye circle adjustment may be used as follows:
  142. (1) Open up (by dropping or through the "open…" menu item) a typical file.
  143. (2) Select the "Adjust Fisdheye Circle…" menu item abnd interactively adjust the circle. Deselect this item.
  144. (3) Without closing the application, drop the batch of files onto the opened DeFish icon.
  145.  
  146. • Saving Images
  147. When satisfied with the results, chose "Save…" from the file menu.
  148.  
  149. • Saving and restoring Preferences
  150. A list of commonly used settings can be saved as preferences.  They are listed under the "Choose settings" menu on the Warp menu. Select "Save Settings…" under the File menu to save them. The file is TEXT, and hence may be edited outside of DeFish. Spaces are added for readability, but are not necessary. Useful settings may be shared among users.
  151.  
  152. • Examples
  153. ◊ Use 100% and 180° for an 8 mm lens on a 35 mm camera.
  154. ◊ Use 180% and 170° for a 16 mm lens on a 35 mm camera. The maximum fields of view are about 93° x 140°. Use the "dangling faces" (hemicube) to quickly find the limits of a new lens.
  155.  
  156. • Bugs
  157. - none known.
  158.  
  159.  
  160. • Feedback
  161. Report bugs, crashes, problems, requests, enhancements, praises, etc. to turk@worldserver.com.
  162.  
  163. Do you have some parameter settings that work well for you? Send them to me, and I'll include them in this file.
  164.  
  165. This application is freeware and runs only on the Power Macintosh. If you feel you must give some money away, please join the International QuickTime VR Association (IQTVRA), and make an extra donation there to encourage immersive media authoring tools, tutorials, and promotions of an open, supportive spirit in our field.
  166.  
  167. Ken Turkowski
  168.